通过该接口对待支付的 order
对象发起一次支付请求,每次请求时需指定用户付款的支付渠道。可以通过多次调用切换付款的渠道,同时生成多个 charge
对象。如果使用测试模式的 API Key,则不会发生真实交易。订单付款完成后,会发送 Webhooks 通知。
请求参数 | 描述 |
---|---|
ORDER_ID required string | Ping++ 返回的 order 对象的 id ,用于商品订单查询、退款,该参数仅需要填写在请求地址内。 |
charge_amount required int | 支付金额,单位分(大于 0,仅优惠券全额抵扣时可填 0)。和组合支付的金额(无组合支付则忽略)相加后,值必须等于订单中的应付金额 - 已付金额 + 已退金额。 |
channel required string | 支付使用的渠道(优惠券全额抵扣时,可不填)。渠道详情请参考 支付渠道属性值,若创建订单时传入了 balance_settlement ,则此处不可使用 balance 渠道。除此之外,还支持使用自定义渠道 custom ,该渠道不需要真实付款,并且会同步返回成功结果。 |
extra conditional hash | 特定渠道发起交易时需要的额外参数,以及部分渠道支付成功返回的额外参数,详细参考 支付渠道 extra 参数说明 。 |
charge_order_no optional string | 支付使用的商户订单号,默认使用订单对象中的商户订单号。当商户订单号在渠道被使用时,需更换新的商户订单号。推荐使用 8-20 位,要求数字或字母,不允许特殊字符。 |
time_expire optional timestamp | 订单失效时间的 Unix 时间戳。时间范围在订单创建后的 1 分钟到 24 小时,创建时间以 Ping++ 服务器时间为准。默认值为订单过期时间或渠道支持的最大过期时间中较小的那一个,但不会超过 24 小时。微信默认为 2 小时,wx_wap 渠道对该参数的有效值限制为 5 分钟;upacp、upacp_pc、upacp_wap、cp_b2b、applepay_upacp 渠道对该参数的有效值限制为 1 小时内;upacp_b2b 对该参数的有效值限制为 1 天内;upacp_qr 渠道对该参数的有效期默认为 1 天,最大为 30 天;此参数对 paypal 及 scan 类渠道无效。 |
combined_with optional hash | 组合支付信息。组合支付是指该次支付和另一渠道共同支付完成,目前仅支持和余额组合支付,如果订单存在未全额退款的 Charge 对象则不能组合支付。详见下方的 combined_with 参数说明 。 |
combined_with 参数说明
参数 | 说明 |
---|---|
channel required string | 支付使用的另一个渠道。不能和支付的 channel 相同,目前仅支持 balance 。 |
charge_amount required int | 支付金额(必须大于 0)。单位分,该金额必须小于订单应付金额。 |
charge_order_no optional string | 该渠道使用的商户订单号,默认和支付的 charge_order_no 值相同。推荐使用 8-20 位,要求数字或字母,不允许特殊字符。 |
返回
返回一个 order
对象,或者返回一个错误,详见 错误。
POST https://api.pingxx.com/v1/orders/{ORDER_ID}/pay
待补充
待补充
待补充
待补充
待补充
待补充
待补充
curl https://api.pingxx.com/v1/orders/2001608270000004428/pay \ -H "Pingplusplus-Signature: SIGNATURE" \ -H "Pingplusplus-Request-Timestamp: 1475029155" \ -H "Content-Type: application/json" \ -u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC: -d '{ "channel": "alipay_qr", "charge_amount": 800 }'
待补充
待补充
待补充
待补充
待补充
待补充
待补充
{
"id": "2001708140000017551",
"object": "order",
"created": 1502695388,
"livemode": false,
"paid": false,
"refunded": false,
"status": "created",
"app": "app_1Gqj58ynP0mHeX1q",
"uid": "user_007",
"available_balance": 0,
"merchant_order_no": "2017081400000006",
"amount": 1000,
"actual_amount": 800,
"amount_refunded": 0,
"amount_paid": 0,
"coupon_amount": 200,
"currency": "cny",
"subject": "Your Subject",
"body": "Your Body",
"client_ip": "127.0.0.1",
"time_paid": null,
"time_expire": 1502781019,
"coupon": "300317081415225500002001",
"description": "",
"metadata": {},
"charge_essentials": {
"channel": "alipay_qr",
"transaction_no": null,
"failure_code": null,
"failure_msg": null,
"credential": {
"object": "credential",
"alipay_qr": "http://sissi.pingxx.com/mock.php?ch_id=ch_1Kyn50DyjXbHbvnv5SGK4qDK&channel=alipay_qr"
},
"extra": {}
},
"receipt_app": "app_1Gqj58ynP0mHeX1q",
"service_app": "app_1Gqj58ynP0mHeX1q",
"available_methods": [
"balance"
],
"charges": {
"object": "list",
"url": "/v1/charges",
"has_more": false,
"data": [
{
"id": "ch_1Kyn50DyjXbHbvnv5SGK4qDK",
"object": "charge",
"created": 1502695440,
"livemode": false,
"paid": false,
"refunded": false,
"reversed": false,
"app": "app_1Gqj58ynP0mHeX1q",
"channel": "alipay_qr",
"order_no": "2017081400000006",
"client_ip": "127.0.0.1",
"amount": 800,
"amount_settle": 800,
"currency": "cny",
"subject": "Your Subject",
"body": "Your Body",
"extra": {},
"time_paid": null,
"time_expire": 1502781019,
"time_settle": null,
"transaction_no": null,
"refunds": null,
"amount_refunded": 0,
"failure_code": null,
"failure_msg": null,
"metadata": {},
"credential": {
"object": "credential",
"alipay_qr": "http://sissi.pingxx.com/mock.php?ch_id=ch_1Kyn50DyjXbHbvnv5SGK4qDK&channel=alipay_qr"
},
"description": null
}
]
}
}